home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / batchut / isclock.zip / ISCLOCK.DOC next >
Text File  |  1991-03-03  |  6KB  |  149 lines
  1.  
  2.  
  3.  
  4.                                 █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
  5.            █▀█▀█▀▀█▀▀█▀▀▀█▀▀▀█▀▀▀ H O R I Z O N S ▀▀▀▀█▀▀▀█▀▀▀█▀▀█▀▀█▀█▀█
  6.            ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ Consulting ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  7.                ≡ 1432 E. Commercial Street ─ Springfield, MO  65803 ≡
  8.                   ≡ Phone: (417) 839-2174 - Fax: (417) 831-1329 ≡
  9.                               ─────── presents ───────
  10.           ▄▄▄▄▄▄▄▄         ▄▄▄▄▄▄▄▄▄▄▄
  11.           █▄▄  ▄▄█         █  ▄▄▄▄▄  █
  12.             █  █   ▄▄▄▄▄▄▄ █  █   █▄▄█ ▄▄▄     ▄▄▄▄▄▄▄ ▄▄▄▄▄▄▄ ▄▄▄   ▄▄tm
  13.             █  █   █ ▄▄▄▄█ █  █        █ █     █ ▄▄▄ █ █ ▄▄▄▄█ █ █ ▄▀ █
  14.             █  █   █ █▄▄▄▄ █  █        █ █     █ █ █ █ █ █     █ █▀ ▄▀
  15.             █  █   █▄▄▄▄ █ █  █   ▄▄▄▄ █ █     █ █ █ █ █ █     █   ▀▄
  16.           ▄▄█  █▄▄ ▄▄▄▄█ █ █  █▄▄▄█  █ █ █▄▄▄▄ █ █▄█ █ █ █▄▄▄▄ █ █▀▄ ▀▄
  17.           █▄▄▄▄▄▄█ █▄▄▄▄▄█ █▄▄▄▄▄▄▄▄▄█ █▄▄▄▄▄█ █▄▄▄▄▄█ █▄▄▄▄▄█ █▄█  ▀▄█
  18.                                 ≡ Copyright 1991 ≡
  19.  
  20.              This  copy  of IsClock is a shareware evaluation  copy.   It
  21.         requires that a key be pressed before each use.  If you find that
  22.         IsClock is a program that meets your needs, please take the  time
  23.         to register.  The registration fee for IsClock is $25.  All users
  24.         who register will receive a release version that does not require
  25.         a key be pressed to execute.
  26.  
  27.              IsClock  is  designed to make accessing the  time  and  date
  28.         functions  of  your system clock with batch files a  much  easier
  29.         task.   IsClock evaluates expressions in an algebraic fashion  to
  30.         return a simple True or False status to your batch file by  using
  31.         the ERRORLEVEL mechanism.
  32.  
  33.              The legal syntax for IsClock is:
  34.  
  35.                   ISCLOCK parameter operator parameter
  36.  
  37.              IsClock will evaluate the expression and set a DOS ERRORLEV-
  38.         EL  of  1 if the expression is True, 0 if False, and 255  if  the
  39.         expression isn't legal.
  40.  
  41.  
  42.         OPERATORS
  43.         ---------
  44.              The legal operators for IsClock are:
  45.  
  46.              =  :  Equals
  47.              ~  :  Equals     [Same as =]
  48.              {} :  Does not equal
  49.              }  :  Is greater than
  50.              {  :  Is less than
  51.              }= :  Is greater than or equal to
  52.              {= :  Is less than or equal to
  53.  
  54.              Note:  The  curly brackets are used instead of the <  and  >
  55.         symbols  since  these symbols are used for DOS  redirection  pur-
  56.         poses.
  57.  
  58.  
  59.         PARAMETERS
  60.         ----------
  61.              The legal parameters for IsClock are:
  62.  
  63.         Day              : Returns current day of the month. (1-31)
  64.         Month            : Returns the current month. (1-12)
  65.         Year             : Returns the year. (Either XX or XXXX format)
  66.         Hour             : Returns the current hour. (00-23)
  67.         Minute           : Returns the current minute. (00-59)
  68.         Second           : Returns the current second. (00-59)
  69.         DayName          : Returns the current Day of Week. (Sun-Sat)
  70.         Date             : Returns the current date. (XX/XX/XX)
  71.         Today            : Same as Date. (XX/XX/XX)
  72.  
  73.  
  74.         CONSTANTS
  75.         ---------
  76.              To  facilitate  ease  of use, the  following  constants  are
  77.         recognized by the IsClock program:
  78.  
  79.                                   Month Names:
  80.                                   ------------
  81.         Jan, January             : Evaluates to 1.
  82.         Feb, February            : Evaluates to 2.
  83.         Mar, March               : Evaluates to 3.
  84.         Apr, April               : Evaluates to 4.
  85.         May                      : Evaluates to 5.
  86.         Jun, June                : Evaluates to 6.
  87.         Jul, July                : Evaluates to 7.
  88.         Aug, August              : Evaluates to 8.
  89.         Sep, September           : Evaluates to 9.
  90.         Oct, October             : Evaluates to 10.
  91.         Nov, November            : Evaluates to 11.
  92.         Dec, December            : Evaluates to 12.
  93.  
  94.                                    Day Names:
  95.                                    ----------
  96.         Sun, Sunday              : Evaluates to 1.
  97.         Mon, Monday              : Evaluates to 2.
  98.         Tue, Tuesday             : Evaluates to 3.
  99.         Wed, Wednesday           : Evaluates to 4.
  100.         Thu, Thursday            : Evaluates to 5.
  101.         Fri, Friday              : Evaluates to 6.
  102.         Sat, Saturday            : Evaluates to 7.
  103.  
  104.  
  105.         EXAMPLES
  106.         --------
  107.         Simple Examples using IsClock:
  108.  
  109.                   ISCLOCK Hour=17
  110.                   ISCLOCK Year}=1999
  111.                   ISCLOCK Dayname{}Friday
  112.                   ISCLOCK Dn{}6
  113.  
  114.  
  115.              Note that in the last two examples given above are the  same
  116.         expression stated two different ways.
  117.  
  118.              IsClock  also supports creating more complex expressions  by
  119.         using the optional operators AND and OR. Examples:
  120.  
  121.              ISCLOCK Hour=8 and DayName}=Monday and Dayname{=Friday
  122.              [Must be time to go to work!]
  123.  
  124.              ISCLOCK Month=11 and dayname=Tuesday and day}1 and day{9
  125.              [Looks like it's election day!]
  126.  
  127.              ISCLOCK year{}1992 or dayname{}4
  128.              [Returns true on all days except Wed, and all days in 1992.]
  129.  
  130.              ISCLOCK today{}01/01/00 or today=01/01/00
  131.              [This always returns true!]
  132.  
  133.              Note: The AND and OR operators cannot be mixed upon the same
  134.         expression line, therefore the following is not legal:
  135.  
  136.              ISCLOCK month=1 and day=1 or day=2
  137.  
  138.              If  you  have any questions regarding the  use  of  IsClock,
  139.         please feel free to call Horizons Consulting, from 8 am to 6  pm,
  140.         Monday thru Friday, or:
  141.  
  142.              ISCLOCK hour=}8 and hour{=18 and dayname}1 and dayname{7.
  143.  
  144.              Thanks  for  taking the time to read this Doc file  and  for
  145.         evaluating IsClock.
  146.  
  147.  
  148.  
  149.